home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / dlc22.zip / DLC.DOC next >
Text File  |  1990-07-20  |  10KB  |  224 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23. █▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒
  24.  
  25.  
  26.                   ╔══════════════════════════════════════╕
  27.   ░░░░▒▒▒▒████    ║       The Impossible Software        │    ░░░░▒▒▒▒████
  28.    ░░░░▒▒▒▒████   ║               Presents               │   ░░░░▒▒▒▒████
  29.     ░░░░▒▒▒▒████  ║             DLC + DLTOPX             │  ░░░░▒▒▒▒████
  30.      ░░░░▒▒▒▒████ ║     A Download Counter + topX        │ ░░░░▒▒▒▒████
  31.     ░░░░▒▒▒▒████  ║         By : Bart van Dongen         │  ░░░░▒▒▒▒████
  32.    ░░░░▒▒▒▒████   ║      Written in TurboPascal v5.5     │   ░░░░▒▒▒▒████
  33.   ░░░░▒▒▒▒████    ║            V2.2(c)1990               │    ░░░░▒▒▒▒████
  34.                   ╙──────────────────────────────────────┘
  35.  
  36. █▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒
  37.            Unregistered Evaluation Copy v2.2 for GT Power v15.x
  38. █▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒▒██▒▒░░▒
  39.  
  40.  
  41. This programm contains the following files :
  42.   DLC.DOC       This documentation file.
  43.   DLC.EXE       The download counter program.
  44.   DLCSETUP.EXE  The program to specifie you're paths ed.
  45.   DLTOPX.EXE    The download TopXX generator.
  46.   TOPCOLOR.EXE  The SetUp programm for the TOPX ansi colors.
  47.   PROTOCOL.DLC  The file in witch the protocol specifications are stored.
  48.  
  49.  
  50. DLC is spread under the SHAREWARE concept. This means that you only may
  51. EVALUATE this copy, and if you want to continue using it after the
  52. evaluation period, you HAVE to register. Then you'll get a Key, so you can
  53. simple register it you're self. If you want to register, fill out the
  54. registerform (DLCFORM.REG) and sent it to me with a check included. Then
  55. you will get the KEY by netmail as soon as possible!!!
  56.  
  57. DLC is a utility for GT. it is compatible with GT 15.0 Upto 15.50. It
  58. has been written, to add a counter in the description of you're
  59. FILES.BBS files, witch counts the times the described file has been
  60. downloaded. It will get it's information from the GT.LOG file, and searches
  61. for GTDIR.BBS to locate you're FILES.BBS files. The best result will be
  62. reached, if you run DLC Right before you run FIXBBS or somthing like
  63. that, because it will ONLY edit the ASCII files, and not the Colored
  64. Ansi files...!!
  65. Before starting up one of the DLC files, you first have to add a line :
  66.    SET DLC = DLCPath
  67. to you're autoexec.bat file, In this DLCPath directory you have to
  68. store : DLC.EXE and DLTOPX.EXE so the programms can locate the it's files.
  69. On the following pages, eatch of the programms will be explained
  70. seperately.
  71.  
  72. -DLCSETUP.EXE
  73.   This is the Setup programm. You have to specifie all you're paths,
  74.   filenames and other values here. here follow a little explanation of
  75.   the therms used.
  76.  
  77.   FilePaths ─┬─> BBS DirFile ──> Enter here the path where GTDIR.BBS is
  78.              │                   located.
  79.              │                   (Default is Env GT)
  80.              ├─> BBS LogFile ──> Enter here the path where the GT LogFile is
  81.              │                   located.
  82.              │                   (Default is Env GT)
  83.              ├─> DLC.Dat ──────> Enter here the path where DLC will store the
  84.              │                   DLC.DAT file.
  85.              │                   (Default is Current dir)
  86.              ├─> DLC.Log ──────> Enter here the path where DLC will store the
  87.              │                   DLC.LOG file.
  88.              │                   (Default is Current dir)
  89.              └─> TOPX.ASC/ANS ─> Enter here the path where DLC will store the
  90.                                  Download topX files.
  91.                                  (Default is Current dir)
  92.  
  93.   FileNames ─┬─> FileList ─────> Enter here the filename of the FileLists.
  94.              │                   (Default = FILES.BBS.)
  95.              ├─> DirList ──────> Enter here the filename of the DirList.
  96.              │                   (Default = GTDIR.BBS)
  97.              ├─> LogFile ──────> Enter here the filename of the GT LogFile.
  98.              │                   (Default = GT.LOG)
  99.              ├─> TopX Ansi ────> Enter here the filename of the Colored TopX
  100.              │                   file.
  101.              │                   (Default = TOPX.ANS)
  102.              └─> TopX Ascii ───> Enter here the name of the NonAnsi TopX
  103.                                  file.
  104.                                  (Default = TOPX.ASC)
  105.  
  106.   Values ───┬──> Min TopXlevel > Enter here the minimum level whitch may be
  107.             │                    showed in the TopX files. Use this option
  108.             │                    if you have 'Special' areas, witsh may not
  109.             │                    be seen by not special users......
  110.             │                    (Default = E)
  111.             ├──> Counter Pos ──> Enter here the position of the Counter in
  112.             │                    the FILES.BBS file.
  113.             │                    (Default = 6)
  114.             ├──> Lines ────────> Enter here on whitch line DLC have to store
  115.             │                    the DownLoadCounter. TopX expects the file
  116.             │                    description to be right after the Counter.
  117.             │                    (Default = 2)
  118.             ├──> Backup ───────> Enter here Wheter of not DLC will Create a
  119.             │                    FILES.BAK after running the Counter.
  120.             │                    (Default = FALSE)
  121.             └──> OldStyle ─────> Enter here wheter or not you use the new
  122.                                  style of GT15.50 in you're FILES.BBS. If
  123.                                  you're filesize is in Bytes, it has to be
  124.                                  TRUE, els set it to FALSE.
  125.                                  (Default is TRUE)
  126.  
  127. -DLC.EXE
  128.   This is the main programm. It INSERTS a counter in the FILES.BBS files,
  129.   found in the GTDIR.BBS file. Every time a file is downloaded, the counter
  130.   will increment one. There are two possible parameters to use with DLC.
  131.   /R  This option will remove the DownLoadCounters from you're FILES.BBS
  132.       files.
  133.   /C  This option will Clear the DownLoadCounters from you're FILES.BBS
  134.       file. In other words: all you're counters will be set to [ 0].
  135.   DLC can handel 1500 files at one time. If there are more files found in
  136.   the GT LogFile, DLC will exit with Error lvl 8, and you'll have to restart
  137.   DLC to count the rest of the files. (see the last page for more Error
  138.   Levels.)
  139.   DLC will keep a LogFile (DLC.LOG), whitch will be larger
  140.   every time DLC is used. If you think it's to long, just delete it.
  141.   It will also create a DLC.DAT file. in this file the last read line of
  142.   the GT.LOG file is stored, so it can continue at that line, the next
  143.   time DLC is run.
  144.  
  145.  -DLTOPX.EXE
  146.    This programm wil create a TopX of the XX mostly downloaded files.
  147.    If you havn't registered yet, You won't be able to create an other top as
  148.    the Top15. If you're DLC is registered, you can specify the TopX length
  149.    by a parameter. this parameter must be in the range 10..254.
  150.    Example : DLTOPX 30
  151.    This will generate a Top30.
  152.  
  153.  -PROTOCOL.DLC
  154.    This is a file in whitch you have to specifie the protocolls you're using
  155.    with GT. There are a vieuw protocolls witch already have been
  156.    specified. if you are using others, or it doesn't work well, you have
  157.    to specifie these protocolls here.
  158.    The structure of the file is as follows :
  159.    FILEPOS ─────────────────┐
  160.    FILECOUNT ──────────┐    │
  161.    LINES ──────────┐   │    │
  162.    NAMEPOS ───┐    │   │    │
  163.    PROTOCOL   │    │   │    │
  164.    ─────────  ──   ─   ───  ──
  165.    ZMODEM     15   M   26   17
  166.    JMODEM     15   M   26   17
  167.    YMODEM-G   15   M   28   17
  168.    KERMIT     15   M   26   17
  169.    LYNX       15   M   24   17   ; This text will be ignored.
  170.    TX:        17   S   0    21   ; the TX: is used for BIMODEM.
  171.  
  172.    Where :
  173.       PROTOCOL  = The EXACT name of the protocol, stored in the GT Log
  174.                   file. This name has to be on the same line as the
  175.                   TX: sign.
  176.       NAAMPOS   = The position of the Protocol name.
  177.       LINES     = Wheter or not the protocoll stores the TX: sign on the
  178.                   same line as the downloaded file names.
  179.                   (Use S for Single Line, M for Multi Line)
  180.       FILECOUNT = The position of the number of downloaded files. in the
  181.                   GT LogFile This option is only used if Lines = M. else
  182.                   set it to 0.
  183.       FILEPOS   = The position of the Downloaded filename in the GT
  184.                   LogFile.
  185.  
  186.    Here follows a little example of the GT LogFile. :
  187.  
  188. Protocol = ZMODEM ; Naampos = 17 ; Lines = M ; FileCount = 26
  189.             │ ┌───────┘  ┌──────────────────────┘
  190.  1-28 24:13 └ ZMODEM TX: 2 FILES  248341 BYTES  0:17.58 TIME  230 CPS
  191.  1-28 24:13    BENCH50.EXE    210073
  192.  1-28 24:13    CORE29.COM      38268
  193.                │
  194. FilePos = 17 ──┘
  195.  
  196. If you have still problems with specifying you're protocolls corectly, please
  197. sent me a NetMail with a part of you're LogFile, and I'll see what I can do
  198. for you.
  199.  
  200. -TOPCOLOR.EXE
  201.   This programm is to SetUp the colors of to TOPX Ansi files.
  202.   Use the Arrow keys to move though the windows, the Escape to quit a
  203.   window and the Enter key to edit or select an option. You have to run
  204.   this, before using DLTOPX.EXE
  205.  
  206. -ErrorLevels.
  207.   Here follows the ErrorLevels witch the programms will exit with, if
  208.   something goes wrong.
  209.  
  210.   0 = Exit whitout an error.
  211.   1 = directory not found, specified in the SET command.
  212.   2 = SET DLC= not found in the environment.
  213.   3 = DLC.CNF file not found.
  214.   4 = GTDIR.BBS file not found.
  215.   5 = GT.LOG file not found.
  216.   6 = PROTOCOL.DLC Error.
  217.   7 = No changes in the LogFile since last run of DLC.
  218.   8 = More then 1500 downloaded files found in the GT LogFile
  219.   9 = TOPX.CNF file not found.
  220.  
  221. I hope you've enough information right now, to use DLC.
  222.  
  223. Enjoy it, and good luck!!!
  224.